home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / biblio / bibtex / utils / bibextract / citefind.txt < prev    next >
Text File  |  1992-11-01  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. CITEFIND(1)              USER COMMANDS                CITEFIND(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      citefind - extract matching bibliography entries from BibTeX
  10.      .bib files
  11.  
  12. SYNOPSIS
  13.      citefind tags-file bibfile(s) >newbibfile
  14.      or
  15.      citefind - bibfile(s) >newbibfile
  16.  
  17. DESCRIPTION
  18.      citefind extracts from a list of  BibTeX  .bib  files  those
  19.      bibliography entries that match a specified list of citation
  20.      tags, possibly produced by citetags(1), sending the  entries
  21.      to  stdout,  together with all BibTeX ``@Preamble{...}'' and
  22.      ``@String{...}'' commands.
  23.  
  24.      If the first argument, tags-file, is ``-'', the tag list  is
  25.      read from stdin, allowing it to be piped from citetags(1).
  26.  
  27.      Bibliography entries are output in the order  found  in  the
  28.      .bib  files.  In the absence of cross references, you may be
  29.      able to use bibsort(1) to sort them by citation key.   While
  30.      such  sorting  is  unnecessary for BibTeX itself, it is con-
  31.      venient for a human reader of the .bib file.
  32.  
  33.      When documents are prepared using a large bibliography  data
  34.      base  collection,  it  is  sometimes convenient to extract a
  35.      subset BibTeX bibliography  file  incorporating  only  those
  36.      entries that are cited in the document.  A good example is a
  37.      document to be submitted to a publisher, or  otherwise  dis-
  38.      tributed in electronic form.
  39.  
  40. BUGS
  41.      citefind is not smart enough  to  incorporate  BibTeX  cross
  42.      references  unless  their  citation tags are included in the
  43.      input list.
  44.  
  45.      No attempt is made to  reduce  the  output  ``@String{...}''
  46.      commands to just those that are actually referenced.
  47.  
  48.      Those features should be added.
  49.  
  50. SEE ALSO
  51.      bibclean(1), bibextract(1),  bibindex(1),  biblook(1),  bib-
  52.      sort(1), bibtex(1), citetags(1).
  53.  
  54. FILES
  55.      /usr/local/lib/bibextract/citefind.awk  nawk(1) program  for
  56.                                              tag extraction.
  57.  
  58.      /usr/local/bin/citefind                 user-callable  shell
  59.                                              script   to   invoke
  60.  
  61.  
  62.  
  63. Version 1.02      Last change: 30 October 1992                  1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CITEFIND(1)              USER COMMANDS                CITEFIND(1)
  71.  
  72.  
  73.  
  74.                                              nawk(1).
  75.  
  76. AUTHOR
  77.      Nelson H. F. Beebe, Ph.D.
  78.      Center for Scientific Computing
  79.      Department of Mathematics
  80.      University of Utah
  81.      Salt Lake City, UT 84112
  82.      USA
  83.      Tel: +1 801 581 5254
  84.      FAX: +1 801 581 4148
  85.      Email: <beebe@math.utah.edu>
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Version 1.02      Last change: 30 October 1992                  2
  130.  
  131.  
  132.  
  133.